home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d1 / inter489.arc / INTPRINT.DOC < prev    next >
Text File  |  1989-07-23  |  5KB  |  117 lines
  1.                             INTPRINT v1.1
  2.                             by Ralf Brown
  3.  
  4. The INTPRINT program is (c) Copyright 1989 Ralf Brown.  All Rights Reserved.
  5. INTPRINT, its source code, and this documentation may be freely redistributed,
  6. but may not be included as part of any work other than the interrupt list
  7. maintained by Ralf Brown.  If any changes are made to the program or its
  8. documentation, the original version must be included with the modified
  9. version.
  10.  
  11. ------------------------------------------------------------------------------
  12.  
  13. INTPRINT.COM is a VERY simple formatter for the interrupt list.  Use
  14. this program to prevent widow or orphan lines at the beginning or end of a
  15. function call, number the pages, center the printout in elite (12 cps) mode,
  16. or create a summary of the function calls.  After formatting is complete, the
  17. total number of pages is displayed on the screen.
  18.  
  19. Usage:
  20.    intprint [options] [lines_per_page [page_length]] <interrup.lst [>outfile]
  21.  
  22. where the options are:
  23.         -e    assume printer is in elite mode (96 characters per line), and
  24.               indent the output eight spaces to center the printout.
  25.  
  26.         -iN   indent the output N spaces.  The output device is assumed to be
  27.               at least 80+N characters wide.
  28.               NOTE: you must put the number immediately after the 'i', no
  29.               blanks are allowed.
  30.  
  31.         -E    assume the printer is an Epson FX80 or compatible, and send
  32.               control sequences to place the printer in elite mode and center
  33.               the printout.  This option overrides -e and forces -i8
  34.  
  35.         -I    assume the printer is capable of producing IBM character graphics
  36.  
  37.         -p    print the page number at the bottom center of each page
  38.  
  39.         -nN   assume N pages have already been printed, and start numbering
  40.               at N+1.  This option allows you to create a properly-numbered
  41.               printout even if there is not enough disk space to concatenate
  42.               the parts of the interrupt list.  See the examples below.
  43.               NOTE: you must put the number immediately after the 'n', no
  44.               blanks are allowed.
  45.  
  46.         -sfile  create a one-line-per-function summary and write it to "file"
  47.               if -n is also given, the summary will be appended to "file",
  48.               allowing a properly numbered summary file to be created even if
  49.               there is not enough disk space to concatenate the parts of the
  50.               list.  See the examples below.
  51.               NOTE: you must put the filename immediately after the 's', no
  52.               blanks are allowed.
  53.  
  54.         -ffile  create a file containing only the data structures described
  55.               in the interrupt list.
  56.               NOTE: you must put the filename immediately after the 'f', no
  57.               blanks are allowed.
  58.  
  59. Options may not be combined; "-ep" is illegal and the "p" will be ignored.
  60.  
  61. Lines_per_page specifies how many lines to print on each page (including the
  62. optional page number), and defaults to 60.
  63.  
  64. Page_length specifies how many lines are on a printed page.  If this value is
  65. omitted, a form feed is used to skip to the next page.  If specified, line
  66. feeds are used to skip to the next page.
  67.  
  68. The file to be formatted is read from standard input, and the formatted result
  69. is sent to standard output.  Both may be redirected using the standard Unix or
  70. MSDOS redirection characters < and >.  If you only want a summary file or
  71. data formats file, redirect the output to the null device ("NUL" under MSDOS,
  72. "/dev/null" under Unix).
  73.  
  74. ------------------------------------------------------------------------------
  75.  
  76. EXAMPLES:
  77. ---------
  78.  
  79.         Print the interrupt list with page numbers, and create a summary file,
  80.         without concatenating INTERRUP.A and INTERRUP.B:
  81.  
  82.                 A> intprint -sb:interrup.sum -p <interrup.a >prn
  83.                 157 pages.   [screen output from INTPRINT]
  84.                 A> intprint -sb:interrup.sum -p -n157 <interrup.b >prn
  85.  
  86.         Create only a summary file:
  87.  
  88.                 C> intprint -sinterrupt.sum <interrup.lst >nul
  89.  
  90.         Print the interrupt list on an Epson FX80, using 54 lines per page and
  91.         omitting both page numbers and summary:
  92.  
  93.                 C> intprint -E 54 <interrup.lst >prn
  94.  
  95.         Print the interrupt list using 120 lines on every 132-line page, and
  96.         make divider lines using IBM character graphics:
  97.  
  98.                 C> intprint -I 120 132 <interrup.lst >prn
  99.  
  100. ------------------------------------------------------------------------------
  101.  
  102. BUGS:
  103. -----
  104.  
  105. Various aligned tables break when the indentation is other than a multiple of
  106. eight.
  107.  
  108. ------------------------------------------------------------------------------
  109.  
  110. PORTABILITY:
  111. ------------
  112.  
  113. INTPRINT.C contains the source code for INTPRINT, for those people who are
  114. using the interrupt list on a machine which does not run MSDOS.  This code has
  115. been tested with Turbo C and Mach (BSD 4.3) "cc".
  116.  
  117.